feat(profound): add Profound AI visibility and analytics integration by waleedlatif1 · Pull Request #3849 · simstudioai/sim

waleedlatif1 · 2026-03-30T22:34:20Z

Summary

Add complete Profound integration with 24 tools covering all API endpoints
Tools: visibility/sentiment/citations reports, bot/referral traffic (v2), raw/bot logs, prompt answers/volume, query fanouts, citation prompts, content optimization, org management (categories, regions, models, domains, assets, personas, topics, tags)
Block config with operation dropdown, conditional fields, per-operation metrics, advanced mode for optional params
Icon, registry entries, and docs with manual description

Type of Change

New feature

Testing

Tested manually

Checklist

Code follows project style guidelines
Self-reviewed my changes
Tests added/updated and passing
No new warnings introduced
I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

vercel · 2026-03-30T22:34:26Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
docs	Ready	Preview, Comment	Mar 30, 2026 11:28pm

cursor · 2026-03-30T22:34:27Z

PR Summary

Medium Risk
Mostly additive, but introduces a new external API integration surface (24 operations) and updates the integration catalog/mappings; misconfiguration or API contract mismatches could break the new block/tool runtime or landing/docs rendering.

Overview
Adds the new Profound integration end-to-end: a ProfoundBlock with an operation dropdown and conditional inputs (including per-report metrics and advanced filters), plus corresponding tool wiring to call profound_* operations.

Wires Profound into both the docs and landing experiences by adding ProfoundIcon, updating icon mappings and tool metadata, and introducing new documentation at tools/profound.mdx. Also updates the integrations catalog JSON (including many tag formatting-only changes) and registers the block in blocks/registry.ts.

^{Written by Cursor Bugbot for commit 6fc7038. Configure here.}

apps/sim/blocks/blocks/profound.ts

…tale overrides

greptile-apps · 2026-03-30T22:40:08Z

Greptile Summary

This PR adds a complete Profound AI visibility and analytics integration to Sim, covering 24 tools across all major Profound API endpoints (reports, logs, org management, content optimization, and prompt volumes). The implementation follows established patterns from other multi-operation blocks (e.g., Ahrefs, GitHub) with a single ProfoundBlock config, a dynamic operation dropdown, per-operation conditional subBlocks, and a params function that remaps the operation-specific metrics fields to the canonical metrics key expected by each tool.

Previous review concerns (duplicate prompt_answers in FILTER_OPS, offset=0 falsy checks in the block config and list_optimizations.ts, and unguarded JSON.parse on filters across all ten affected tools) have all been addressed in commit 226987b.

Remaining findings:

The block's params function guards the operation-specific metrics lookup with a plain truthiness check (if (metricsField && params[metricsField])), which is inconsistent with the != null pattern already applied to limit and offset in the same function. An explicit empty-string check would prevent a TypeError in the unlikely case that a required metrics field reaches execution as an empty string.
ProfoundCitationPromptsResponse.output.data is typed as unknown, providing no structure for consumers or documentation. A Record<string, unknown> with a comment would be an improvement until the Profound citation-prompts response schema is confirmed.

Confidence Score: 5/5

Safe to merge; all previously reported P1 issues have been fixed and remaining findings are P2 style/quality suggestions.
All critical issues from the prior review round (unguarded JSON.parse, falsy offset=0, duplicate array entry) are confirmed resolved. The two remaining findings are minor: one is a style inconsistency in a guard condition that the required-field validation already protects in practice, and the other is an untyped response payload. Neither blocks correct execution of any of the 24 tools.
apps/sim/blocks/blocks/profound.ts (metrics truthy check at line 372) and apps/sim/tools/profound/types.ts (unknown output type for citation prompts at line 419)

Important Files Changed

Filename	Overview
apps/sim/blocks/blocks/profound.ts	Main block config: defines 24 operations with conditional subBlocks, per-operation metrics mapping, and a params function that remaps operation-specific metric fields. The params function uses a truthy guard for metrics (minor inconsistency with `!= null` pattern used elsewhere); all previously flagged issues (duplicate `prompt_answers` in FILTER_OPS, `offset=0` falsy check) have been resolved.
apps/sim/tools/profound/types.ts	Comprehensive type definitions for all 24 tools; well-structured. `ProfoundCitationPromptsResponse.output.data` is typed as `unknown`, providing no contract for downstream consumers.
apps/sim/tools/profound/visibility_report.ts	POST to /v1/reports/visibility; filters JSON.parse wrapped in try/catch, limit uses != null guard, response shape mapped correctly.
apps/sim/tools/profound/citation_prompts.ts	GET to /v1/prompt-volumes/citation-prompts using URLSearchParams; output `data` typed as `json` with no properties, mirroring the `unknown` type issue in types.ts.
apps/sim/tools/profound/raw_logs.ts	Hardcodes `metrics: ['count']`, handles both array and wrapped-object response shapes, filters try/catch present.
apps/sim/tools/profound/category_prompts.ts	GET with multi-value query params (topic_id, tag_id, region_id, platform_id) appended via searchParams.append; cursor-based pagination exposed; limit uses != null guard.
apps/sim/tools/profound/list_optimizations.ts	GET with offset+limit in query params; both use != null guards (previously-reported issue fixed); response mapped correctly.
apps/sim/tools/registry.ts	All 24 profound tools imported and registered correctly; no missing or duplicate entries.
scripts/generate-docs.ts	Adds a `biomeSortCompare` helper to match Biome's organizeImports order for icon mapping generation; clean utility addition with no side-effects.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    UI[ProfoundBlock UI\noperation dropdown] --> OP{operation}

    OP -->|list_categories/regions/\nmodels/domains/assets/personas| LIST[List Tools\nGET /v1/org/...]
    OP -->|category_topics/tags/\nprompts/assets/personas| CAT[Category Tools\nGET /v1/org/categories/:id/...]
    OP -->|visibility_report\nsentiment_report\ncitations_report\nquery_fanouts\nprompt_answers| CREP[Category Report Tools\nPOST /v1/reports/...]
    OP -->|bots_report\nreferrals_report| DREP[Domain Report Tools\nPOST /v2/reports/...]
    OP -->|raw_logs\nbot_logs| LOGS[Log Tools\nPOST /v1/logs/raw...]
    OP -->|list_optimizations\noptimization_analysis| CONT[Content Tools\nGET /v1/content/:assetId/...]
    OP -->|prompt_volume| PVOL[Prompt Volume\nPOST /v1/prompt-volumes/volume]
    OP -->|citation_prompts| CPROM[Citation Prompts\nGET /v1/prompt-volumes/citation-prompts]

    subgraph params_fn [Block params function]
        MF[metricsMap lookup\nvisibilityMetrics → metrics\nbotsMetrics → metrics\netc.] --> MR[result.metrics]
        LIM[limit != null] --> NL[result.limit as Number]
        OFF[offset != null] --> NO[result.offset as Number]
    end

    CREP & DREP & PVOL -->|metrics required| params_fn
    params_fn --> TOOL[Tool executes\nX-API-Key header]
    LIST & CAT & LOGS & CONT & CPROM --> TOOL

_{Reviews (4): Last reviewed commit: "fix(generate-docs): produce Biome-compat..." | Re-trigger Greptile}

apps/sim/tools/profound/visibility_report.ts

apps/sim/tools/profound/list_optimizations.ts

apps/sim/blocks/blocks/profound.ts

… remove duplicate prompt_answers in FILTER_OPS

waleedlatif1 · 2026-03-30T22:43:38Z

@greptile

waleedlatif1 · 2026-03-30T22:43:42Z

@cursor review

apps/sim/tools/profound/category_personas.ts

… order

…dation test

waleedlatif1 · 2026-03-30T23:03:24Z

@cursor review

waleedlatif1 · 2026-03-30T23:03:27Z

@greptile

… part of ParamConfig)

…cs generator compatibility

cursor

✅ Bugbot reviewed your changes and found no new issues!

Comment @cursor review or bugbot run to trigger another review on this PR

…erator

waleedlatif1 · 2026-03-30T23:20:13Z

@greptile

waleedlatif1 · 2026-03-30T23:20:17Z

@cursor review

cursor

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

apps/sim/app/(landing)/integrations/data/integrations.json

The generator wrote multi-line arrays for short string arrays (like tags) and omitted trailing newlines, causing Biome format check failures in CI. Post-process integrations.json to collapse short arrays onto single lines and add trailing newlines to both integrations.json and meta.json. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

feat(profound): add Profound AI visibility and analytics integration

688c933

vercel bot deployed to Preview March 30, 2026 22:37 View deployment

cursor bot reviewed Mar 30, 2026

View reviewed changes

apps/sim/blocks/blocks/profound.ts Show resolved Hide resolved

fix(profound): fix import ordering and JSON formatting for CI lint

357f44c

vercel bot temporarily deployed to Preview March 30, 2026 22:38 Inactive

fix(profound): gate metrics mapping on current operation to prevent s…

4bb1836

…tale overrides

vercel bot temporarily deployed to Preview March 30, 2026 22:39 Inactive

greptile-apps bot reviewed Mar 30, 2026

View reviewed changes

apps/sim/tools/profound/visibility_report.ts Show resolved Hide resolved

apps/sim/tools/profound/list_optimizations.ts Show resolved Hide resolved

apps/sim/blocks/blocks/profound.ts Show resolved Hide resolved

apps/sim/blocks/blocks/profound.ts Show resolved Hide resolved

fix(profound): guard JSON.parse on filters, fix offset=0 falsy check,…

226987b

… remove duplicate prompt_answers in FILTER_OPS

vercel bot temporarily deployed to Preview March 30, 2026 22:42 Inactive

lint

3fbb67c

vercel bot deployed to Preview March 30, 2026 22:46 View deployment

fix(docs): fix import ordering and trailing newline for docs lint

217a5ae

cursor bot reviewed Mar 30, 2026

View reviewed changes

apps/sim/tools/profound/category_personas.ts Show resolved Hide resolved

fix(scripts): sort generated imports to match Biome's organizeImports…

af43982

… order

vercel bot deployed to Preview March 30, 2026 22:57 View deployment

fix(profound): use != null checks for limit param across all tools

a224331

vercel bot temporarily deployed to Preview March 30, 2026 22:59 Inactive

fix(profound): flatten block output type to 'json' to pass block vali…

18e2218

…dation test

vercel bot temporarily deployed to Preview March 30, 2026 23:00 Inactive

fix(profound): remove invalid 'required' field from block inputs (not…

50fe6f1

… part of ParamConfig)

vercel bot temporarily deployed to Preview March 30, 2026 23:05 Inactive

fix(profound): rename tool files from kebab-case to snake_case for do…

a2131bf

…cs generator compatibility

vercel bot temporarily deployed to Preview March 30, 2026 23:09 Inactive

cursor bot reviewed Mar 30, 2026

View reviewed changes

lint

e00be8a

vercel bot deployed to Preview March 30, 2026 23:14 View deployment

waleedlatif1 added 2 commits March 30, 2026 16:17

fix(docs): let biome auto-fix import order, revert custom sort in gen…

8f629d9

…erator

fix(landing): fix import order in sim icon-mapping via biome

d8e3875

vercel bot temporarily deployed to Preview March 30, 2026 23:17 Inactive

fix(scripts): match Biome's exact import sort order in docs generator

6fc7038

vercel bot deployed to Preview March 30, 2026 23:22 View deployment

cursor bot reviewed Mar 30, 2026

View reviewed changes

apps/sim/app/(landing)/integrations/data/integrations.json Show resolved Hide resolved

vercel bot deployed to Preview March 30, 2026 23:28 View deployment

waleedlatif1 merged commit e5aef61 into staging Mar 30, 2026
11 checks passed

waleedlatif1 deleted the waleedlatif1/add-profound branch March 30, 2026 23:30

waleedlatif1 mentioned this pull request Mar 31, 2026

v0.6.18: file operations block, profound integration, edge connection improvements, copy logs, knowledgebase robustness #3861

Merged

Conversation

waleedlatif1 commented Mar 30, 2026

Summary

Type of Change

Testing

Checklist

Uh oh!

vercel bot commented Mar 30, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

cursor bot commented Mar 30, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

PR Summary

Uh oh!

Uh oh!

greptile-apps bot commented Mar 30, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Greptile Summary

Confidence Score: 5/5

Important Files Changed

Flowchart

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

waleedlatif1 commented Mar 30, 2026

Uh oh!

waleedlatif1 commented Mar 30, 2026

Uh oh!

Uh oh!

waleedlatif1 commented Mar 30, 2026

Uh oh!

waleedlatif1 commented Mar 30, 2026

Uh oh!

cursor bot left a comment

Choose a reason for hiding this comment

Uh oh!

waleedlatif1 commented Mar 30, 2026

Uh oh!

waleedlatif1 commented Mar 30, 2026

Uh oh!

cursor bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

vercel bot commented Mar 30, 2026 •

edited

Loading

cursor bot commented Mar 30, 2026 •

edited

Loading

greptile-apps bot commented Mar 30, 2026 •

edited

Loading